home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / fm2utils.zip / fm2utils.doc < prev    next >
Text File  |  1997-05-06  |  11KB  |  321 lines
  1.  
  2.     FM/2 Utilities, a utility collection for use with File Manager/2
  3.          copyright (c) 1994/95 by M. Kimes (Barebones Software)
  4.                           all rights reserved
  5.     ================================================================
  6.  
  7. This is a collection of utilities that may prove useful in conjunction
  8. with FM/2 (or even without it).  While FM/2 is shareware (you must pay
  9. for it if you continue using it beyond a 30-day trial period), this
  10. utility collection is offered as free-for-the-using (you don't have to
  11. pay for it to use it).
  12.  
  13. All the .EXE utilities provide help if you run them with /? as an
  14. argument (hint:  arguments shown in brackets [] are optional, arguments
  15. shown in braces <> are required).  The .CMD utilities may be directly
  16. inspected using a text editor and are commented as to use and function.
  17. It's recommended that you place these utilities into a directory on your
  18. PATH (type HELP PATH at a command prompt if you don't know what that
  19. means).  If you have FM/2 installed, may I suggest you make a UTILS
  20. directory off your FM/2 directory?
  21.  
  22. These utilities are standalone, meaning that one doesn't rely on
  23. another.  You can therefore delete any you don't want to keep around
  24. without affecting the operation of any of the others.
  25.  
  26. If you like the FM/2 Utilities package, you'll love FM/2.  File
  27. Manager/2 (FM/2) is a shareware OS/2 2.1+ PM 32-bit
  28. file/directory/archive maintenance utility (a sort of super-Drives
  29. object, something midway between the Drives objects and a more
  30. traditional file manager) with plenty of bells, whistles and utilities,
  31. drag and drop, context menus, toolbars and accelerator keys.  FM/2 won a
  32. 1995 OS/2 Magazine Editor's Choice award -- the only file management
  33. software to do so.  If you know how to use OS/2, you already know how to
  34. use most of FM/2.  You can easily glean the rest from the extensive
  35. online help.  FM/2 is available from ftp.secret.com (/g/os2utl), from
  36. Compuserve's OS2SHARE (OS2BVEN) forum (GO OS2SHARE) in library 18, and
  37. from finer OS/2 BBSs everywhere.
  38.  
  39.  
  40. Following is a very brief description of each program in the package:
  41.  
  42. BEEP.EXE
  43.     Makes a beep noise.
  44.  
  45. CVT4OS2.CMD
  46.     Converts 4DOS/4OS2 non-standard DESCRIPT.ION files to WPS-standard
  47.     .SUBJECT EAs.
  48.  
  49. CVTFBBS.CMD
  50.     Converts FILES.BBS file comments to WPS-standard .SUBJECT EAs.
  51.  
  52. DELTREE.EXE
  53.     Deletes a directory and all its subdirectories and files.
  54.  
  55. DRVRLIST.EXE
  56.     Lists all mounted drivers.  Use /w switch for a "wide" listing.
  57.  
  58. DRVTYPES.EXE
  59.     Lists all drives with information on their types.
  60.  
  61. DSTART.EXE
  62.     A START command that will work from DOS VDMs (penalty box).
  63.  
  64. EJECT.EXE
  65.     Eject media from a removable drive.  Notes:  when EJECT, LOCK or
  66.     UNLOCK returns an error code of 31, it usually means that function
  67.     is not supported for the requested drive.  "The parameter is not
  68.     correct" may mean you tried it on a non-existent or fixed drive.
  69.     Error 163 is not in the OS/2 message file; it's "uncertain media,"
  70.     and usually just repeating the command will "fix" it.
  71.  
  72. FATOPT.EXE*
  73.     An OS/2 FAT optimizer -- defragment, condense freespaces, sort file
  74.     and directory names, test sectors in system areas, test (and repair
  75.     some damaged) clusters, report on drive usage.  If you receive a
  76.     "FATOpt can't lock" message from FATOpt, the drive is in use and
  77.     FATOpt can't optimize it; try booting from floppies (place
  78.     FATOPT.EXE on the floppy together with VIOCALLS.DLL).  If you
  79.     receive a "FATOpt ran out of memory" error, add RAM and/or set up a
  80.     swapfile on a partition other than the one being optimized (type
  81.     HELP SWAPPATH at a command line for more info) and/or try the -p
  82.     or -q switches.  Other errors (uncommon) should be self-explanatory,
  83.     if distressing.  CHKDSK/F should be run before running FATOpt, and
  84.     it's always a good idea to back up before defragging.  FATOpt
  85.     errorlevel returns for batch files:  0 = no problems, 1 = user
  86.     abort, 2 = out of memory, 3 = bad file (run CHKDSK/F, dammit),
  87.     4 = can't open drive, 5 = can't lock drive, 6 = can't fix bad
  88.     cluster, 7 = insufficient free space on drive, 8 = unknown error,
  89.     9 = bad system area, 10 = error during standard file copy.
  90.     BACKUP BEFORE OPTIMIZING.  REMEMBER THE BEST OPTIMIZATION IS
  91.     ACCOMPLISHED BY A BACKUP/DELETE/RESTORE.
  92.  
  93. FINDPATH.EXE
  94.     List a PATH-style environment variable's directories (or LIBPATH),
  95.     or find a file or files in those directories.  Perhaps useful for
  96.     tracking down files that appear in more than one directory on the
  97.     PATH or LIBPATH.
  98.  
  99. FLUSH.EXE
  100.     Flush file system caches and buffers (make system quiescent).
  101.  
  102. FM2PLAY.EXE*
  103.     Used by FM/2 to play multimedia files with the "Play Multimedia"
  104.     command (requires MMPM/2).
  105.  
  106. HPFSOPT.EXE*
  107.     An HPFS optimizer.
  108.  
  109. ICONIFY.EXE
  110.     "Iconifies" image files, which is to say that it sets the icon
  111.     of image files to be miniature versions of the image files.  A
  112.     PM program, but designed to be run in batch mode from a command
  113.     line.
  114.  
  115. IMAGE.EXE*
  116.     Used by FM/2 to quickly display image files (requires MMPM/2).
  117.     Check the system menu for options.
  118.  
  119. ISTEXT.EXE
  120.     Returns ERRORLEVEL 1 if a file appears to be a text (ASCII) file,
  121.     0 if not or file is inaccessible.
  122.  
  123. KILL2.EXE
  124.     A timed deletion/touch/list utility.
  125.  
  126. KILLPID.EXE
  127.     Kill processes by PID or title, or list PIDs of running processes.
  128.     See also SWITCHTO.EXE.
  129.  
  130. KEYLOCKS.EXE
  131.     Control state of num lock, caps lock, scroll lock.  Note:  PM
  132.     program, but still designed to be run from command line.
  133.  
  134. LA.EXE
  135.     Lists the contents of archive files, extracts files from archives
  136.     using one command without you having to know the archive type or
  137.     archiver commands (requires ARCHIVER.BB2 datafile to be on your
  138.     PATH or DPATH, copy included in the archive, edit to taste/need).
  139.  
  140. LINES.EXE
  141.     Counts lines in text files.
  142.  
  143. LOCK.EXE
  144.     Lock a removable drive.
  145.  
  146. MAKEOBJ.CMD
  147.     Creates WPS objects for filenames -- program objects for programs,
  148.     shadows for everything else -- on the desktop.
  149.  
  150. MKPATH.EXE
  151.     Make directories many levels deep with one command.
  152.  
  153. MOV.EXE
  154.     A MOVE command that can move between drives and optionally allows
  155.     overwriting.
  156.  
  157. MSENSIT.EXE
  158.     Set sensitivity of mouse.
  159.  
  160. NO.EXE
  161.     Hides file system objects, then runs a command (excludes file system
  162.     objects from a command).
  163.  
  164. NOCAD.EXE
  165.     Disables/reenables (toggles) CTRL-ALT-DEL.
  166.  
  167. OPEN.CMD
  168.     Opens a WPS object.
  169.  
  170. PRIORITY.EXE
  171.     A launch-with-priority program that lets you set the priority of
  172.     other programs when you start them.
  173.  
  174. PTREE.EXE
  175.     Displays the tree of a given path, several options.
  176.  
  177. QFORMAT.EXE
  178.     Quick format floppies by zapping the root and FATs.  NOTE:  Warp's
  179.     FORMAT will do this, too (/Q switch).
  180.  
  181. QPLAY.EXE
  182.     Quiet play plays multimedia files via MMPM/2 without showing itself
  183.     (perhaps useful from batch files).
  184.  
  185. REBOOT.EXE
  186.     Reboots the system as though you'd pressed CTRL-ALT-DEL.
  187.  
  188. REBOOTP.EXE
  189.     Reboots the system as though you'd pressed CTRL-ALT-DEL after
  190.     broadcasting a WM_QUIT message to all children of the desktop and
  191.     waiting 60 seconds for the applications to save their settings and
  192.     quit (note that VIO and DOS applications will pop up their "Are you
  193.     sure?" boxes, but you don't have to be there to answer (and
  194.     shouldn't be -- use Shutdown instead if you're not automating),
  195.     though such apps won't pick up on the hint to shut down).  This is a
  196.     PM application, but still designed to be run from command line.
  197.  
  198. REMTAB.EXE
  199.     Removes TABs from text files.
  200.  
  201. RENCASE.EXE
  202.     Renames files to the same name but all upper, lower or "mixed" case.
  203.  
  204. RESET.EXE
  205.     Resets a drive.
  206.  
  207. SAVEDESK.EXE
  208.     Saves the Desktop, optionally restarts WPS by killing it and letting
  209.     it restart itself.
  210.  
  211. SCOPY.EXE
  212.     Copy new files and/or newer versions of existing files.  Primarily
  213.     intended for backup and synchronization.
  214.  
  215. SDIR.CMD
  216.     Directory listing that shows .SUBJECT EAs.
  217.  
  218. SMODE.EXE
  219.     Set screen modes (columns, rows, resolutions) for VIO/full screen
  220.     sessions or reports on available modes.
  221.  
  222. SNAPSHOT.EXE
  223.     Creates a "snapshot" file compatible with PMDMatch.
  224.  
  225. SR.EXE
  226.     Simple search-and-replace command, optional interactive mode.
  227.     Intended to be used non-interactively for many files in a single
  228.     pass (otherwise a text editor is more suitable).
  229.  
  230. SRCH.CMD
  231.     A search command for OS/2 (finds text in files).
  232.  
  233. STRIP.EXE
  234.     Filter that strips specified strings from input.
  235.  
  236. SUBJ.CMD
  237.     Show and modify .SUBJECT EAs.
  238.  
  239. STRIPCDS.EXE
  240.     A filter that strips ANSI and VT-100 escape codes from stdin and writes
  241.     the results to stdout.
  242.  
  243. SWEEP.CMD
  244.     A sweep command for OS/2; performs a command in all subdirectories of
  245.     the current directory.
  246.  
  247. SWITCHTO.EXE
  248.     Switch current or a specified process (by PID or partial title) to
  249.     the foreground.
  250.  
  251. TEST.EXE
  252. TEST.CMD
  253. TESTPM.EXE
  254.     Repeat all the arguments it receives; useful for debugging command
  255.     lines and figuring out what arguments one program receives from
  256.     another.
  257.  
  258. TESTDRV.EXE
  259.     Test a drive.  Should be run with a drive other than the one being
  260.     tested as the default for best results (saves a logfile listing any
  261.     bad sectors found to the default directory).
  262.  
  263. TESTFIND.EXE
  264.     Tests an IFS's DosFindFirst/Next implementation.
  265.  
  266. TESTHAND.EXE
  267.     Reports the number and type of inherited file handles.
  268.  
  269. TESTRC.EXE
  270.     Runs a program and reports its return code (ERRORLEVEL).
  271.  
  272. TYPERATE.EXE
  273.     Sets the typematic rate.
  274.  
  275. UNARJER.CMD
  276.     Unarjs any arj file dropped onto it into the same directory where
  277.     the arj file resides, then opens a folder for that directory.
  278.  
  279. UNIQUE.EXE
  280.     Counts the number of lines, words and unique words in a text file,
  281.     gives a breakdown of how many times each unique word was used.
  282.  
  283. UNLOCK.EXE
  284.     Unlock a removable drive.
  285.  
  286. UNLZHER.CMD
  287.     Unlzhs any lzh file dropped onto it into the same directory where
  288.     the lzh file resides, then opens a folder for that directory.
  289.  
  290. UNZIPPER.CMD
  291.     Unzips any zip file dropped onto it into the same directory where
  292.     the zip file resides, then opens a folder for that directory.
  293.  
  294. WHERE.CMD
  295.     A where command for OS/2; finds files on a specified or the default
  296.     drive.
  297.  
  298. WIPE.EXE
  299.     Wipes then erases files so that their data cannot be recovered.
  300.     Meets DOD standards.
  301.  
  302.                                                     * Used by "stock" FM/2.
  303.  
  304.  
  305. Simple license statement:
  306. ========================
  307. These utilities may be freely used by end users.  I retain copyright and
  308. reserve all rights.  There is NO warranty expressed or implied.
  309.  
  310. Distribution rights are granted for online (dial-up, Internet, CIS,
  311. etc.) services ONLY without prior written permission from author.
  312. If you want to distribute for money, you MUST contact me first and
  313. make arrangements.
  314.  
  315.  
  316. Author contact info:
  317. ===================
  318.   Mark Kimes (CIS 74601,1327; (318)222-3455 voice and fax; mkimes@softdisk.com)
  319.   542 Merrick
  320.   Shreveport, LA  71104  USA
  321.